Foxit PDF SDK
FoxitPDFSDKPython3.Image类 参考
类 FoxitPDFSDKPython3.Image 继承关系图:
FoxitPDFSDKPython3.Base

Public 成员函数

def Image ()
 构造函数。
更多...
 
def Image (buffer, length)
 构造函数,从内存缓冲区。
更多...
 
def Image (file_read)
 构造函数,使用文件读取回调对象。
更多...
 
def Image (other)
 构造函数,使用另一个图像对象。
更多...
 
def Image (path)
 构造函数,从现有图像文件路径。
更多...
 
def AddFrame (bitmap)
 添加位图作为帧。(不支持的DIB格式:FoxitPDFSDKPython3.Bitmap.e_DIBRgb565 FoxitPDFSDKPython3.Bitmap.e_DIB8bppMask
更多...
 
def GetFrameBitmap (index)
 根据索引获取帧位图。
更多...
 
def GetFrameCount ()
 获取帧数。
更多...
 
def GetHeight ()
 获取图像高度。
更多...
 
def GetOrientation ()
 获取图像方向。
更多...
 
def GetType ()
 获取图像类型。
更多...
 
def GetWidth ()
 获取图像宽度。
更多...
 
def GetXDPI ()
 获取X轴的DPI。
更多...
 
def GetYDPI ()
 获取Y轴的DPI。
更多...
 
def IsEmpty ()
 检查当前对象是否为空。
更多...
 
def SaveAs (file, file_extension)
 将当前图像保存为图像文件。
更多...
 
def SaveAs (file_path)
 将当前图像保存为图像文件。
更多...
 
def SetDPIs (x_dpi, y_dpi)
 设置X轴和Y轴的DPI。
更多...
 

静态 Public 属性

 e_BMP = _fsdk.Image_e_BMP
 图像类型是BMP。

 
 e_GIF = _fsdk.Image_e_GIF
 图像类型是GIF。

 
 e_JBIG2 = _fsdk.Image_e_JBIG2
 图像类型是JBIG2。
更多...
 
 e_JPG = _fsdk.Image_e_JPG
 图像类型是JPG或JPEG。

 
 e_JPX = _fsdk.Image_e_JPX
 图像类型是JPX或JPEG-2000。

 
 e_None = _fsdk.Image_e_None
 尚未有图像类型。
更多...
 
 e_OrientationFlipH = _fsdk.Image_e_OrientationFlipH
 水平翻转。

 
 e_OrientationFlipV = _fsdk.Image_e_OrientationFlipV
 垂直翻转。

 
 e_OrientationNone = _fsdk.Image_e_OrientationNone
 无方向。

 
 e_OrientationNormal = _fsdk.Image_e_OrientationNormal
 正常方向。

 
 e_OrientationRotate180 = _fsdk.Image_e_OrientationRotate180
 顺时针旋转180度。

 
 e_OrientationRotate270 = _fsdk.Image_e_OrientationRotate270
 逆时针旋转90度。

 
 e_OrientationRotate270FlipH = _fsdk.Image_e_OrientationRotate270FlipH
 先逆时针旋转90度,然后水平翻转。

 
 e_OrientationRotate90 = _fsdk.Image_e_OrientationRotate90
 顺时针旋转90度。

 
 e_OrientationRotate90FlipH = _fsdk.Image_e_OrientationRotate90FlipH
 先顺时针旋转90度,然后水平翻转。

 
 e_PNG = _fsdk.Image_e_PNG
 图像类型是PNG。

 
 e_TIF = _fsdk.Image_e_TIF
 图像类型是TIF或TIFF。

 
 e_Unknown = _fsdk.Image_e_Unknown
 未知图像类型。

 
 e_WEBP = _fsdk.Image_e_WEBP
 图像类型是webp。
更多...
 

详细描述

Foxit PDF SDK提供以下图像类型:

  • BMP:位图图像格式。只支持单帧。Foxit PDF SDK支持从BMP图像文件加载图像, 获取一些基本信息,获取其位图,更改其位图并将其保存为图像文件。
  • JPG:联合图像专家组图像格式。只支持单帧。Foxit PDF SDK支持从JPG图像文件加载图像, 获取一些基本信息,获取其位图,更改其位图并将其保存为图像文件。
  • PNG:便携式网络图形图像格式。只支持单帧。Foxit PDF SDK支持从PNG图像文件加载图像, 获取一些基本信息,获取其位图,更改其位图并将其保存为图像文件。
  • GIF:图形交换格式。支持多帧。Foxit PDF SDK支持从GIF图像文件加载图像, 获取其大小,获取其位图,更改其位图并将其保存为图像文件。
  • TIF:标签图像文件格式。支持多帧。Foxit PDF SDK支持从TIF图像文件加载图像, 获取一些基本信息,获取其位图,更改其位图并将其保存为图像文件。
  • JPX:JPEG-2000图像格式。只支持单帧。Foxit PDF SDK支持从JPX图像文件加载图像, 获取其大小,获取其位图,更改其位图并将其保存为图像文件。
  • JBIG2:JBIG2图像格式。只支持单帧。Foxit PDF SDK支持从JBIG2图像文件加载图像, 获取其大小,并将其保存为图像文件。Foxit PDF SDK尚不支持获取其帧位图。


构造及析构函数说明

◆ Image() [1/5]

def FoxitPDFSDKPython3.Image.Image ( )

构造函数。

此构造函数用于构造一个新的图像对象(不包含任何数据)。 此构造的图像对象的图像类型为 FoxitPDFSDKPython3.Image.e_None

◆ Image() [2/5]

def FoxitPDFSDKPython3.Image.Image (   path)

构造函数,从现有图像文件路径。

参数
[in]path现有图像文件的完整路径。不应为空字符串。

◆ Image() [3/5]

def FoxitPDFSDKPython3.Image.Image (   buffer,
  length 
)

构造函数,从内存缓冲区。

参数
[in]buffer内存缓冲区。图像文件数据应完全加载到此内存缓冲区中。 不应为 null
[in]length内存缓冲区的大小。应大于0。

◆ Image() [4/5]

def FoxitPDFSDKPython3.Image.Image (   file_read)

构造函数,使用文件读取回调对象。

参数
[in]file_read用户实现的 FoxitPDFSDKPython3.FileReaderCallback 对象,用于加载图像文件。 不应为 null

◆ Image() [5/5]

def FoxitPDFSDKPython3.Image.Image (   other)

构造函数,使用另一个图像对象。

参数
[in]other另一个图像对象。

成员函数说明

◆ AddFrame()

def FoxitPDFSDKPython3.Image.AddFrame (   bitmap)

添加位图作为帧。(不支持的DIB格式:FoxitPDFSDKPython3.Bitmap.e_DIBRgb565 FoxitPDFSDKPython3.Bitmap.e_DIB8bppMask

目前此函数不支持类型为 FoxitPDFSDKPython3.Image.e_JBIG2 FoxitPDFSDKPython3.Image.e_Unknown 的图像。
对于支持的图像类型:


参数
[in]bitmap要添加或设置的有效位图帧。
返回
true 表示成功,false 表示失败。

◆ GetFrameBitmap()

def FoxitPDFSDKPython3.Image.GetFrameBitmap (   index)

根据索引获取帧位图。

目前此函数不支持类型为 FoxitPDFSDKPython3.Image.e_JBIG2 的图像。 此函数只能支持获取以下格式的帧位图:
FoxitPDFSDKPython3.Bitmap.e_DIB8bppMask FoxitPDFSDKPython3.Bitmap.e_DIB8bpp FoxitPDFSDKPython3.Bitmap.e_DIBRgb FoxitPDFSDKPython3.Bitmap.e_DIBRgb32 FoxitPDFSDKPython3.Bitmap.e_DIBArgb
对于其他不支持的DIB格式,此函数将返回一个位图对象, 其函数 FoxitPDFSDKPython3.Bitmap.IsEmpty 返回 true

参数
[in]index帧的索引。有效范围:从0到(count-1)。 count 由函数 FoxitPDFSDKPython3.Image.GetFrameCount 返回。
返回
帧位图。如果返回的位图对象的函数 FoxitPDFSDKPython3.Bitmap.IsEmpty 返回值为 true,则表示该帧的DIB格式不受支持。

◆ GetFrameCount()

def FoxitPDFSDKPython3.Image.GetFrameCount ( )

获取帧数。

目前此函数不支持类型为 FoxitPDFSDKPython3.Image.e_JBIG2 的图像。

返回
帧数。

◆ GetHeight()

def FoxitPDFSDKPython3.Image.GetHeight ( )

获取图像高度。

如果图像有多帧,通常第一帧的大小将被视为图像大小。

返回
图像高度。

◆ GetOrientation()

def FoxitPDFSDKPython3.Image.GetOrientation ( )

获取图像方向。

此函数只支持类型为 FoxitPDFSDKPython3.Image.e_JPG FoxitPDFSDKPython3.Image.e_TIF 的图像。

返回
图像方向。请参考从 FoxitPDFSDKPython3.Image.e_OrientationNone 开始的值, 这将是其中的一个值。

◆ GetType()

def FoxitPDFSDKPython3.Image.GetType ( )

获取图像类型。

如果当前图像是新图像(不是从任何图像文件构造的),其类型为 FoxitPDFSDKPython3.Image.e_None

返回
图像类型。请参考从 FoxitPDFSDKPython3.Image.e_Unknown 开始的值, 这将是其中的一个值。

◆ GetWidth()

def FoxitPDFSDKPython3.Image.GetWidth ( )

获取图像宽度。

如果图像有多帧,通常第一帧的大小将被视为图像大小。

返回
图像宽度。

◆ GetXDPI()

def FoxitPDFSDKPython3.Image.GetXDPI ( )

获取X轴的DPI。

目前此函数不支持类型为 FoxitPDFSDKPython3.Image.e_JPX FoxitPDFSDKPython3.Image.e_GIF FoxitPDFSDKPython3.Image.e_JBIG2 FoxitPDFSDKPython3.Image.e_WEBP 的图像。
对于新图像(不是从任何图像文件构造的),X轴的默认DPI为96。

返回
X轴的DPI值。

◆ GetYDPI()

def FoxitPDFSDKPython3.Image.GetYDPI ( )

获取Y轴的DPI。

目前此函数不支持类型为 FoxitPDFSDKPython3.Image.e_JPX FoxitPDFSDKPython3.Image.e_GIF FoxitPDFSDKPython3.Image.e_JBIG2 FoxitPDFSDKPython3.Image.e_WEBP 的图像。
对于新图像(不是从任何图像文件构造的),Y轴的默认DPI为96。

返回
Y轴的DPI值。

◆ IsEmpty()

def FoxitPDFSDKPython3.Image.IsEmpty ( )

检查当前对象是否为空。

当前对象为空时,表示当前对象无用。

返回
true 表示当前对象为空,false 表示不为空。

◆ SaveAs() [1/2]

def FoxitPDFSDKPython3.Image.SaveAs (   file,
  file_extension 
)

将当前图像保存为图像文件。

如果当前图像的类型为 FoxitPDFSDKPython3.Image.e_TIF FoxitPDFSDKPython3.Image.e_GIF FoxitPDFSDKPython3.Image.e_None ,且保存的图像文件类型不支持多帧, 则只有当前图像的第一帧会被保存到图像文件中。
如果保存的图像文件类型为 FoxitPDFSDKPython3.Image.e_WEBP ,当前图像的位图格式 应为 FoxitPDFSDKPython3.Bitmap.e_DIBRgb 、 或 。
对于图像对象(不是从任何图像文件构造的),请确保在使用此函数之前 至少向图像对象添加一个有效的帧位图; 否则此函数将失败。

参数
[in]file用户实现的 FoxitPDFSDKPython3.StreamCallback 对象,用于保存图像文件。
[in]file_extension保存的图像文件的完整路径。不应为空字符串。
目前此函数支持以下扩展名:
.bmp、.jpg、.jpeg、.png、.tif、.tiff、.jpx、.jp2。
返回
true 表示成功,false 表示失败。
注解
此函数不支持将当前图像对象保存回用于构造当前图像对象的图像文件。 为了实现这一点,建议用户按以下步骤操作:
假设当前图像对象是从名为"org.bmp"的图像文件构造的。
  1. 使用当前函数将当前图像对象保存到临时文件。这里,此临时文件 命名为"temp.tmp"。
  2. 确保当前图像对象已析构。
  3. 删除"org.bmp"并将"temp.tmp"重命名为"org.bmp"。

◆ SaveAs() [2/2]

def FoxitPDFSDKPython3.Image.SaveAs (   file_path)

将当前图像保存为图像文件。

如果当前图像的类型为 FoxitPDFSDKPython3.Image.e_TIF FoxitPDFSDKPython3.Image.e_GIF FoxitPDFSDKPython3.Image.e_None ,且保存的图像文件类型不支持多帧, 则只有当前图像的第一帧会被保存到图像文件中。
如果保存的图像文件类型为 FoxitPDFSDKPython3.Image.e_WEBP ,当前图像的位图格式 应为 FoxitPDFSDKPython3.Bitmap.e_DIBRgb 、 或 。
对于图像对象(不是从任何图像文件构造的),请确保在使用此函数之前 至少向图像对象添加一个有效的帧位图; 否则此函数将失败。

参数
[in]file_path保存的图像文件的完整路径。不应为空字符串。
目前此函数支持以下扩展名:
.bmp、.jpg、.jpeg、.png、.tif、.tiff、.jpx、.jp2。
返回
true 表示成功,false 表示失败。
注解
此函数不支持将当前图像对象保存回用于构造当前图像对象的图像文件。 为了实现这一点,建议用户按以下步骤操作:
假设当前图像对象是从名为"org.bmp"的图像文件构造的。
  1. 使用当前函数将当前图像对象保存到临时文件。这里,此临时文件 命名为"temp.tmp"。
  2. 确保当前图像对象已析构。
  3. 删除"org.bmp"并将"temp.tmp"重命名为"org.bmp"。

◆ SetDPIs()

def FoxitPDFSDKPython3.Image.SetDPIs (   x_dpi,
  y_dpi 
)

设置X轴和Y轴的DPI。

目前此函数不支持类型为 FoxitPDFSDKPython3.Image.e_JPX FoxitPDFSDKPython3.Image.e_GIF FoxitPDFSDKPython3.Image.e_JBIG2 FoxitPDFSDKPython3.Image.e_WEBP 的图像。

参数
[in]x_dpiX轴的DPI。应大于0。
[in]y_dpiY轴的DPI。应大于0。
返回
None。

类成员变量说明

◆ e_JBIG2

FoxitPDFSDKPython3.Image.e_JBIG2 = _fsdk.Image_e_JBIG2
static

图像类型是JBIG2。

注解
目前,类 Image 中只有少数函数支持此类型。

◆ e_None

FoxitPDFSDKPython3.Image.e_None = _fsdk.Image_e_None
static

尚未有图像类型。

注解
仅适用于新的图像对象,该对象不是从任何图像文件构造或 从其他对象检索的。

◆ e_WEBP

FoxitPDFSDKPython3.Image.e_WEBP = _fsdk.Image_e_WEBP
static

图像类型是webp。

注解
目前,在Android、iOS、linux arm和mac arm平台上不支持。